My Simple Shaman (WoW Classic 20주년 서버 & TBC 호환용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.5 (빌드 20505)
Version: 1.1.3 (2026. 4. 23.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Shaman은 토템과 주요 스킬 및 버프 상태를 한눈에 파악하고 효율적으로 관리하며, 다양한 전투 로그 알림을 제공하도록 순수 Lua로 가볍게 작성된 주술사 전용 애드온입니다.

■ 현재 접속한 캐릭터가 주술사일 때만 활성화되며, 토템 설치 자동화 매크로 생성, 속성별 토템 설정, 토템 버프 대상 추적, 각종 보호막 및 무기 강화 상태 추적, 버프 발동이나 쿨다운 및 지속시간에 대한 개인 채팅 알림을 제공합니다. (경보음 선택 가능) 또한 Chatterbox Announcer의 기능을 통합하여 본인 디버프, 마법흡수, 차단, 아군 해제, 적군 정화, 적대적 시전에 대한 다양한 채팅 알림을 제공합니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 토템 및 무기 버프
 - 속성별 버튼: 대지, 불, 물, 바람 순서의 4개 버튼과 주무기/보조무기 버프 버튼까지 총 6개의 버튼으로 구성됩니다.
 - 개별 플라이아웃 버튼: 버튼 마우스오버 시에 시전 가능한 최대 레벨의 토템/버프 목록이 나타납니다.
 - Shift+우클릭: 1번부터 4번 버튼까지 해당 속성 토템을 공백으로 설정합니다.
 - 좌클릭/우클릭: 설정된 토템을 개별적으로 설치하거나 해당 무기에 버프를 부여합니다.
 - 토템 버프 대상: 내 토템의 영향을 받고 있는 파티원들을 토템 버튼 상단에 직업명 한글 약자 또는 네모로 직업 고유 색상을 입혀서 표시합니다. 내가 토템에서 멀어져서 버프가 없어질 때는 해당 토템 버튼에 빨간색 테두리를 표시합니다.
 - 비설정 토템 아이콘: 버튼에 설정되지 않은 토템을 설치하면 버튼 아이콘이 회색으로 변하며, 현재 설치된 토템의 아이콘을 '토템 버프 대상'의 위에 표시합니다.
 - 무기 버프 버튼에 표시되는 지속시간은 오일도 포함합니다.

■ 자동 매크로 생성(MSS)
 - 4개 속성의 토템을 모두 선택하면 캐릭터 공용 매크로 탭에 'MSS'라는 이름의 매크로를 자동으로 생성/갱신합니다.
 - '/castsequence' 형식을 사용하여 한 버튼으로 모든 토템을 순차적으로 설치할 수 있습니다.
 - Shift+우클릭으로 공백 설정한 속성의 토템은 포함하지 않습니다.

■ 토템의 부름 버튼, 토템 세트 및 UI 토글 버튼(톱니바퀴)
 - 토템의 부름: 30레벨 미만이라서 미습득시에는 툴팁에 (미습득)이 표시됩니다.
 - 토템 세트 설정: 다양한 상황에 맞는 토템 세트를 저장, 불러오기, 삭제할 수 있습니다.
 - 토템 세트 플라이아웃 버튼: 버튼에 마우스오버를 해서 저장된 토템 세트를 간편하게 선택하여 설정합니다.
 - 이동 잠금/해제 토글: 우클릭으로 해제하고 두 버튼 바나 연녹색 테두리를 드래그한 다음에 다시 우클릭으로 잠급니다.
 - 순환식 크기 토글: Shift+우클릭으로 36픽셀부터 60픽셀까지 8픽셀 단위로 확대합니다. 60픽셀에서 한번 더 클릭하면 36픽셀로 돌아옵니다.

■ 토템 속성 순서
 - 설정 창에서 토템 버튼의 속성 순서를 변경할 수 있습니다. 변경시 기존의 토템 세트는 초기화됩니다.

■ 버프 및 소모품 추적기
 - 보호막: 자신에게 걸려 있는 보호막의 중첩 수, 지속시간을 표시합니다.
 - 윤회 및 십자가: 윤회 스킬의 쿨다운과 현재 가방에 보유 중인 십자가 개수를 표시합니다.
 - 수면 걷기/수중 호흡: 아이콘 및 재료 개수를 표시합니다.

■ 주요 쿨다운 스킬
 - 대지의 정령 토템, 불의 정령 토템, 정기의 깨달음/주술의 분노/자연의 신속함, 마나 해일 토템, 영혼의 귀환, 피의 욕망/영웅심 버튼을 따로 두고 지속시간(영혼의 귀환은 남은 시전시간)과 쿨다운을 표시합니다.

■ 쿨다운 및 상태: 개인 채팅 및 경보음
 - 쿨다운 알림: 주요 스킬(윤회, 피의 욕망, 정령 토템), 종족 특성의 쿨다운 종료 10초 전과 종료 시점에 화면 중앙에 색상별 메시지를 출력합니다. 정기의 깨달음, 주술의 분노, 자연의 신속함, 마나 해일 토템, 속박의 토템, 마법정화 토템, 마법흡수 토템, 불꽃 회오리 토템은 종료 시점에 메시지를 출력합니다.
 - 상태 알림: 자신에게 보호막이 없을 때(파란색), 자신에게 번개 또는 물 보호막이 있는데도 아군에게 '대지의 보호막'을 시전하지 않았을 때(노란색), 무기 버프 지속시간 10초 이하일 때, 치유의 길 3중첩 미유지일 때, 정기의 집중 또는 주술의 집중이 발동될 때 메시지를 출력합니다.
 - 출력 방식을 화면 중앙 메시지 및 경보음을 재생하는 ON(RW), 화면 중앙 메시지만 출력하는 ON 중에서 선택하거나 OFF로 비활성화할 수 있습니다. OFF를 선택하면 각 개인 채팅 체크박스의 선택 여부와 상관없이 모두 비활성화합니다.
 - RW 경보음: 재생 여부 및 파일 선택이 가능합니다. 본 애드온 폴더 안에 원하는 ogg 확장자 파일을 MSS_RW.ogg로 저장하면 해당 파일을 경보음으로 사용하고, 그렇지 않다면 RaidWarning.ogg를 재생합니다.

■ 전투 로그: 공개 채팅
 - 본인 디버프, 마법흡수, 차단, 아군 해제, 적군 정화에 대한 채팅 알림을 제공합니다.
 - 출력 방식을 일반(SAY), 파티(PARTY), 공격대(RAID), 감정표현(EMOTE) 중 하나로 선택하거나 OFF로 비활성화할 수 있습니다.

■ 적대적 시전 알림
 - 즉시 시전, 나에게 시전, 시전 무시, 차단 불가 주문(Spell ID) 목록을 설정 창에서 직접 추가하고 목록을 확인 및 초기화할 수 있습니다.
 - 출력 모드: ON(공개채팅+RW), ON(공개채팅), ON(개인채팅+RW), ON(개인채팅), OFF 총 5가지 모드를 지원하며 OFF 시 기능이 비활성화됩니다.
 - 출력 채널: 일반(SAY), 파티(PARTY), 공격대(RAID), 감정표현(EMOTE) 중에서 선택할 수 있습니다.
 - 활성화했더라도 휴식 상태가 되는 대도시나 여관에서는 알림이 출력되지 않습니다.
 - RW 경보음: 재생 여부 및 파일 선택이 가능합니다. 본 애드온 폴더 안에 원하는 ogg 확장자 파일을 MSS_RW.ogg로 저장하면 해당 파일을 경보음으로 사용하고, 그렇지 않다면 RaidWarning.ogg를 재생합니다.

─────────────────────────────
3. 명령어 및 사용 방법
─────────────────────────────
■ 기본 명령어
 - /간단술사 또는 /mss : 설정 창 열기

■ 토템 세트 설정
 - /간단술사 저장 [세트 이름]: 토템 세트 저장
 - /간단술사 [세트 이름]: 토템 세트 불러오기 (또는 중간의 톱니바퀴 버튼)
 - /간단술사 삭제 [세트 이름]: 토템 세트 삭제

■ 이동 잠금/해제 및 크기 변경
 - 토템 세트 버튼(톱니바퀴)을 우클릭해서 이동 잠금/해제를, Shift+우클릭해서 크기를 토글

─────────────────────────────
4. 설치 방법
─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요.
Interface
└── AddOns
    └── MySimpleShaman
        ├── MySimpleShaman.lua
        ├── MySimpleShaman_Vanilla.toc
        ├── MySimpleShaman_TBC.toc
        ├── README.txt
        └── MSS_RW.ogg (선택 사항 - 커스텀 경보음)

■ 게임 내 '애드온' 탭에서 [My Simple Shaman]이 활성화되어 있는지 확인합니다.

─────────────────────────────
5. 주의사항
─────────────────────────────
■ 주술사 전용: 이 애드온은 주술사 이외의 직업으로 접속하면 동작하지 않습니다. 설정은 각 캐릭터마다 저장되므로 주술사 여러 개를 키운다면 각각 설정해야 합니다.

■ 이동 상태 제한: UI 이동 잠금이 해제된 상태(연녹색 테두리 표시)에서는 토템 설치나 무기 버프 부여가 작동하지 않으므로, 위치 설정 후 반드시 다시 잠가주시기 바랍니다.

■ 매크로 슬롯: 매크로 자동 생성 기능을 사용하려면 공용 매크로 탭에 최소 한 칸의 여유 공간이 있어야 합니다.

■ 토템 세트 이름은 1~2글자로 할 것을 권장합니다. 전투 중에는 토템 세트를 불러올 수 없습니다.

■ 토템 속성 순서를 변경하면 기존의 토템 세트가 초기화됩니다.

■ 상태/쿨다운, 적대적 시전 알림에서 RW는 본인에게만 적용됩니다.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 4. 1.)
 - 토템 세트 설정/저장/불러오기/삭제/자동 매크로 생성
 - 토템, 보호막, 무기 강화, 윤회, 피의 욕망/영웅심, 발동 버프, 종족 특성을 포함한 쿨다운 스킬을 추적하고 개인 채팅 및 경보음으로 알림
 - 토템 버프를 받고 있는 대상을 표시
 - 전투 로그(본인 디버프, 마법흡수, 차단, 아군 해제, 적군 정화)를 공개 채팅으로 알림

■ 1.1.0 (2026. 4. 4.)
 - 추적기 수정(윤회 재료 개수와 쿨다운 위치 변경, 주무기/보조무기 버프 삭제, 수면 걷기 및 수중 호흡 이동)
 - 버튼 수정(피의 욕망/영웅심 1-5 → 2-6 이동, 토템 세트 1-6 → 1-6과 2-6 사이 이동, 
 1-5와 1-6에 주무기/보조무기 버프 추가, 1-5와 2-5 사이에 토템의 부름 추가)
 - 토템 세트 버튼에 피의 욕망/영웅심 버튼의 이동 잠금/해제 토글 기능(Shift+우클릭)을 옮기고(우클릭) 순환식 크기 토글 기능(Shift+우클릭)을 추가
 - 본인의 토템 버프 유무 표시 추가
 - 매크로 갱신 알림 삭제

■ 1.1.1 (2026. 4. 6.)
 - 설정 창의 '토템 버프 대상' 체크 오류, '정기의 집중'과 '주술의 집중' 추적 오류 수정

■ 1.1.2 (2026. 4. 12.)
 - 상태 알림용의 화면 중앙 메시지가 조건을 충족하면 바로 삭제되도록 수정

■ 1.1.3 (2026. 4. 23.)
 - Chatterbox Announcer의 '적대적 시전' 알림 기능을 추가로 통합

─────────────────────────────
7. 저작권 및 이용 조건
─────────────────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

─────────────────────────────
8. 개발자 정보
─────────────────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드
